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r Why is tcl broken? ^10^ 

(Mira) Hello, Fm trying to collect a list of all the _carrent_issues 
making tcl a bad language choice. I'd like concrete examples, and 
I not J list vague assertions fljat . . . 



(Jannsen) High, is there a way to get the MAC-addtesses and ofber 
propenies of network cards with python? flianx. Halger . . , 

Asseninoohiectdass 

<Adi) In a method, I'd like to asset that a parameter is an object 
which is of a specific class or has this class as it's ba^e class. I can 
test on the _olass_ and its . . . 

KBHrr in a Windows Environment 

{Zunmerle) I am usmg Python 1,52 in a Windows 98 environment 
I recently tried using the kbhitQ function m t]ie msvert module. It 
appears to work fme in the Fy^on . ■ ■ 

Py&onwin - advise sought 

(Williams) I am lookmg at Pythonwm as an alternative to Tk and 
would appreciate advice on the following three questions. The 
Pythonwin documentation points to MFC ,., 

force sequenz with onlv one item? 

(Jannsen) High, I thin it's easy to solve, but I couldn't get it right 
now. Take a look at the command-line source bclOTv; >»A = 0 
»> B = 1 »> seq=raw_input("?") ? A3»> . . . 



(Milliger) I read the documentation in tiie Pydion Reference 
Library (6.3) on time access and converaions and chapter 8 in 
progranuning python, yet I can 't figure out if . , . 

Advice on an how to handle enors in extension module , 

(Oliphant) I'm wrilins some Pytiton-C interfeces to some 
mathematical libraries in FORTRAN. In parliciilar, I'm working 
on ujterfacmg QUADPACK with Python, The code is . , . 
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Ic mcdeimottf^v-deia.com 06/1 1 f99 02:37 

Hi. r am trying to send a plain text file, as an attachment tkrough e- ^ 
mail. This is a hacked version of my test cade below, basically the 
program intciprcts a dump &om a diary . . . 

06/11/99 06:07 

Reading the source in MimeWrile.py I'd suggest moving these ^ — 
lines up just behind ihe subwrite = . . . line. The startbodyO call 
flushes tiie headers for you . . . 



-302 



-302 



-302 



Here is tiiie right sequence Cfi«t -write header then body), subwriter 
=- w-nextpanO subwriter.addheader{"Content-Traiisfer-Encoding", 
"base04") ... 



k mcdermott@mv-deia.com 06/1 1/99 08:02 

302 

TTiflnka Marc-Andre. It works great (good guess). Guido had^itr-^ 

posted a message almost a year ago (which the code I vwrote is a 
modification of) but I couldn't quite . . . 
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[Schutenbiirg: I have been using a freeware product called 
Autoduck to document my Pyflion source code] 



Cool! I use AutoDuck to document all my Pyihon extension C-h- code. All the 
helpfiles in the Win32 extensions are generated using auiodock. 

Sorry in advance for tiie length of Hiis, but I am in exactly the same 
predicament as you, and have been thinking for a number of years how to resolve 
this. I'm really pleased to finally find someone else with this problem, and really 
hope we can solve it in a reasonable way — 

However, depending on how far you have gone with AuioDuck, pyUiondoc/gendoc 
isn't solving the exact same problem. 

TMO, AutoDack generates far superior reference documentation. 

A new release of pythondoc uses XMI. I believe, so PythonDuck could be a 
tool that can enhance the documentation generated by pythondoc. 

But in summary, Pythondoc exists and is very cool> but doesn't quite cover 
what AutoDuck can do (and vise-versa, but tliat isn't die point now). I believe a real 
need exists for the functionality AutoDack provides, and further I need it personally! 
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[Schulenburg; I have been using a freeware product called 
Autoduck to document my Python sowce code.] 



Cool! I use AutoDuck to document all my Py&on extension C++ code. All the 
helpfiles in the Win32 extensions axe generated using autoduck. 

As another paster pointed out, you should look at pydtondoc/gendoc. Sony in 
advance for the length of this, but I am in exactly die same piedicament as you, and 
have been thinking for a nunAer of years how to resolve d\is. I'm really pleased to 
finally find someone else with this problem, and really hope we can solve it m a 
reasonable way. 

However, dependmg on how far you have gone with AutoDuck, pythondoc/gendoc 
Isn't solving the exact same problem. Well, they all attempt to solve die same 
problem, but have different strengths. 

IMO, AutoDuck generates lar superior reference documentatiDn. Pythondoc's big 
strength is ihe integration with Pytition. 

AutoDuck as 3 strengths over pytiiondoc that I am having trouble reconciling: 
pytbondoc really doesn't support natural links to objects. Autoduck can say "see 
method" or "@xref objectmethod" to generate inline links or a cross-references 
section. Has been some discussion how to expand Pythondoc to support this, but a) it 
hasn't been done and b) it still is not as natural as autoduck. 

I have come to the conclusion that we need a _new_tool - PythonDuck. It should 
work wLdi Pythondoc, and be capable of enhancing its output. A new release of 
pythondoc uses XMI. I believe, so PythonDuck could be a tool that can enhance the 
documentation generated by pythondoc. Alternatively we just graft it in, and beat up 
Daniel until he agrees :-) 

"Hiis tool could possibly still work from comments, or maybe &;om the tad'Cnd of the 
docstrings (thereby stripped from the documentation, and not messing the raw 
docstrmg too much). #@ comments could be considered "directives" for the 
generated output Eg. "#@ xref SomeOtherFunction" will create a cross-references 
section. A comment such as #@ paramtype param name" would direct fliat the 
param called "param_name" should be documented as being of type "SomeType" 
and a cross-reference to the SomeType definition be added. The tool should resolve 
all links at the end, and report bad links. 

1 know I am not making my point that well, and unfortunately don't have tune to fix 
this. But in summary, Pytbondoc exists and is very cool, but doesn't quite cover 
what AutoDuck can do (and vise-versa, but tliat isn't the point now). I believe a real 
need exists for the functionality AutoDuck provides, and further I need it personally! 
So wc should try and make this happen. 



Mark. 
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